
	      *******************************	
	      *	KEYMASTER GEMATRIA SOFTWARE *
	      *	      -INSTRUCTIONS-        *
	      *******************************


KeyMaster is a program designed to search the Hebrew Old Testament
for words, phrases, or verses whose total gematria value equal a
user-specified numeric value. An additional feature is the ability
to search for verses with a specified word count or letter count.

The KeyMaster executable comes with a "Data" folder and a "Report" 
folder. Make sure that both of these are in the same directory as
the executable. The data folder must contain the four data files
which KeyMaster requires to operate: WordMatrix.dat, LineData.dat,
Hebrew.txt, and EnglishOT.html. 



SEARCHING FOR NUMERIC VALUES:
-----------------------------

The numeric value that you want to search for is entered in the 
"Numeric value" field in the top left corner. KeyMaster will print
the results of the search to an HTML file in the "Report" folder. 
Enter the name that you want this file to be saved under in the 
"Report Name" field. It is not necessary to include the ".htm" or 
".html" extension - this will be added automatically. The optional 
"Report Header" field is for any comments that you want to appear 
at the beginning of the report.

There are a number of parameter options that you must select from 
in the "Search Type" box. The first set of options asks you to 
choose between a "Word/Phrase Match" or a "Line Match". A 
"Word/Phrase Match" will search for an individual word or a group
of consecutive words matching the specified value. This type of 
search will only match on a group of words within the same verse. 
In other words, it won't pull back the last word of a verse and the
first word of the following verse as a matching phrase.

A "Line Match" searches for a verse or group of consecutive verses 
whose total value equals the specified value. When this option is 
selected, another set of three options below it is enabled. This 
asks you to choose whether you want to find lines that match on 
word count, letter count, or gematria value. 

The last set of options asks you to choose between a "Single Match"
or "Multiple Match". A "Single Match" will only search for  
individual words or lines which match the target value. A 
"Multiple Match" will bring back both individual words/lines and
groups of consecutive words/lines.



REPORTS:
--------

The report file will print out each verse where a match is found, in
both the transliterated Hebrew and English text. If a Word/Phrase 
match has been specified, then the matching words or phrases in the
Hebrew text will be bolded and italicized. Some of the Hebrew 
letters can be interpreted as having an alternate value when 
found at the end of a word. KeyMaster will match words on both the 
standard value and the alternate value. For instance, "ShMIM" would
come back on a search of either 390 or 950. Any words, phrases, or 
lines which match on the alternate values will be shown in 
parentheses. 

A match on alternate values is only considered valid where the 
alternate values are applied consistently. For instance, consider 
that there are two consecutive words in a verse, each one having an 
alternate value. If the combined standard values of the two words 
equal the search value, or if the combined alternate values equal 
the search value, then the two words will constitute a matching 
phrase. But the standard value of one plus the alternate value of 
the other will not be considered a valid match. 

Each verse listed on the report will have a hyperlink to the main 
body of the text in the EnglishOT.html file.

A multiple line match on word count or letter value is generally not
very practical, as this tends to bring back a stupendous number of
matches. For this reason, the reports on these types of search are 
formatted differently, in order to reduce processing time and 
cumbersome report sizes. A simple range of verses will be listed for
each match, but no text will be printed.



REPORT FILTER
-------------

Common words or phrases which are used with high frequency throughout
the Hebrew Old Testament can produce a great deal of "noise" in your
search results. The "Report Filter" button can be used to weed out
certain text matches from an already existing report. Enter the name
of the report that you want to filter in the "Report Name" field. In
the "Filter Text" field, type the text that you want filtered out. Be
sure that the text which you enter is consistent with the 
transliteration schema shown below, including the proper use of case.
Otherwise, it will not be recognized correctly. For instance, don't 
enter "HARTZ" when you mean to filter "HARTz". 

If the "Report Header" field is not blank, it will replace whatever 
header is already in the report, or add a new header if the report 
does not already have one.



THE KILL SWITCH:
----------------

KeyMaster runs very quickly. Processing time will depend on the CPU 
speed and memory of your machine, but for the most part, reports 
should process within a matter of seconds. The only case in which a 
search is likely to take a long time is if you're running a 
multiple line count on a very high search value. A progress meter 
will be shown when running a multiple line match, along with a Kill
button in case you run out of patience.



RANGE TOTALS:
-------------

To find the numeric totals on a selected range of verses, enter the
start and end verses and click the button. If you just want the 
totals for a single line, then simply enter the same line for the 
start and end verse. When the starting values are entered, the ending
values automatically synchronize with them to accommodate this.



TRANSLITERATION:
----------------

The Hebrew letters are represented in the reports by the 
following schema:

	Aleph	A	1
	Beth	B	2
	Gimel	G	3
	Daleth	D	4
	He	H	5
	Vau	V	6
	Zain	Z	7
	Cheth	Ch	8
	Teth	T	9
	Yod	I	10
	Kaph	K	20, 500 final
	Lamed	L	30
	Mem	M	40, 600 final
	Nun	N	50, 700 final
	Samekh	S	60
	Ayin	O	70
	Peh	P	80, 800 final
	Tzaddi	Tz	90, 900 final
	Qoph	Q	100
	Resh	R	200
	Shin	Sh	300
	Tau	Th	400



